home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 025a / bk5a1rep.zip / CHANGES.DOC < prev    next >
Text File  |  1991-11-29  |  26KB  |  410 lines

  1.  
  2.  
  3.  This document tells about the changes in Brother's Keeper version 5.0.  Users
  4.  of version 4.5 will know how to use the features in 5.0 after reading this.
  5.  If you have never used Brother's Keeper before, then you should read the
  6.  complete documentation in BK5DOC or BROTHER.DOC.
  7.  
  8.  The CONVERT5 program will convert your version 4 or 4.5 data to 5.0.  You may
  9.  create the version 5.0 data files in the same directory as the version 4 data
  10.  and it will not mess up the version 4 data.  Also, the new programs have new
  11.  names, so they can be in the same directory as the 4.5 programs if you wish.
  12.  (However, I would recommend that you put version 5.0 in a new directory.)
  13.  The CONVERT5 program does not copy or move the $$TEXTFILES and it does not
  14.  change the path for the $$TEXTFILES, so keep that in mind if you put the
  15.  programs and data into a new directory.  For example: if you have the line
  16.  $$C:\BK\SMITH.TXT in a message line, the program will still expect to find
  17.  the file in the \BK directory.
  18.  
  19.  To start the conversion program, type CONVERT5 and that will load Btrieve and
  20.  then start the conversion program.  If you have over 2,000 names in your
  21.  files, it will take a while to convert.  The conversion is one of the slowest
  22.  parts of the program, however, once the data is converted the new program
  23.  will run as fast or faster than version 4.5.
  24.  
  25.  To start version 5.0 of BK, type BK5 and that will start Btrieve and then BK.
  26.  
  27.  NOTICE:  If you do not have a hard disk to hold the data files, then I would
  28.           recommend that you do not use version 5.0 (use 4.5C instead).
  29.  
  30.  Here is a summary of the changes in version 5.0.
  31.  
  32.  1.  A person may be given two sets of parents.  Just add the person as a child
  33.      using the normal Add routine.  When you add the person to the second set
  34.      parents, the program will ask you if you really want to do that.
  35.  2.  Designate type of parents (default is birth - others are adopted, step,
  36.      foster, other).  You may do this for one set of parents or both.
  37.  3.  Source lines (3 full lines for each date/location) may be entered to show
  38.      where you found information about an event (date/location).  The experts
  39.      say "document your sources".
  40.  4.  The Ref: field may be used to find people.  (Instead of code number)
  41.  5.  Mailing address information and phone number may be entered. (press F4)
  42.  6.  The size of the files is limited only by your disk size.  If you have
  43.      enough disk space, you may enter 999,999 individuals. The previous limit
  44.      was 15,000 (or 18,000 if you stretched it.)
  45.  7.  Unique locations are saved on disk only once (to save disk space).
  46.  8.  The built in editor can edit 120 lines instead of only 24.  Also, it now
  47.      includes word wrap when typing.
  48.  9.  The file structure is all new.  If you have over 1,000 names in the file,
  49.      the program will start faster than version 4.5.
  50.  10. New fields: "Marr. ceremony Y/N"  "Divorced/Annulled/Separated"  "End year"
  51.  11. The "check" field data is moved to the "page" field of sources.
  52.  12. A quality of data field is shown after the page field in sources.  This
  53.      information is used by programs such as Roots III to track the reliability
  54.  
  55.  
  56.      of the data shown.  If the date referenced is a guess, make it quality 0.
  57.  13. There is limited mouse support.  For menu and data entry and editor.
  58.  14. Individual add.  Add a single person (not as child or spouse of someone).
  59.      Use the individual add routine if you don't want to link to anyone.
  60.  15. Every word in the program can be changed by using the BK5WORDS program.
  61.      When the Brother's Keeper program starts, it reads a file containing the
  62.      desired words.  The same Brother's Keeper program will run in a foreign
  63.      language (already translated into French, German, Polish, Danish, and
  64.      Norwegian.) The BK5MAIN program reads LANGUAGE.BK5, the Ancestor routine
  65.      reads LANGUAGE.BKA, the Group routine reads LANGUAGE.BKG, and the Tree
  66.      routine reads LANGUAGE.BKT.  BK5WORDS creates all LANGUAGE files.  You
  67.      do not need to use BK5WORDS unless you want to change some words in the
  68.      program or on the printouts.
  69.  16. On the modify screen, if a person has message lines, there will be an M
  70.      on the top line and if a person has an address, there will be an A.  Also
  71.      if the person has source data, a dash will be before the date field name.
  72.  17. If the program is not able to determine the person's last name correctly,
  73.      you may put [ before the last name and ] after the last name.
  74.  18. I STRONGLY recommend that you keep the DATA files on a HARD disk.
  75.      Otherwise this program will run VERY slowly.  I repeat, do NOT put the
  76.      DATA files on a floppy diskette.
  77.  19. When adding a location, if you think the location was used before, then
  78.      type a few letters and press F8 to display matching locations to pick.
  79.  20. If the BKOPTION file is found on the disk, the program will find the
  80.      Path for the data files, and proceed to the main menu.  If you want the
  81.      program to say "press enter to start" then start the program with the
  82.      line BK5 /H and that will cause it to hold on the first screen.
  83.  21. In modify, while on the bottom line type / to delete a person.  This will
  84.      physically erase the person, and terminate all links to parents, spouses,
  85.      and children.  That person's code number will then not be used again,
  86.      although the disk space will be used by another number.
  87.  22. A new options screen 3 is available.  You may specify the characters to
  88.      use to surround an unusual last name.  The [] characters are normally
  89.      used, but you may want to use something else such as {} or <>.  You may
  90.      enter the number of lines used by mailing labels, and which address lines
  91.      you want to print on each label.  You may set up use of the BKAUDIT file.
  92.      You may set up to show the date of last update for each person on the
  93.      Modify screen.  You may enter the character to use at the beginning of
  94.      message lines that you NEVER want to print.  You may enter the ASCII value
  95.      for the character for the vertical bar on ancestor charts and when
  96.      printing the compressed group sheets.  The character is normally ASCII 124
  97.      which is |, but some countries don't have that character available.  And
  98.      you may enter the codes for superscript for your printer.  Those codes
  99.      are used when printing source footnotes on group sheets.  The superscript
  100.      codes may also be set up by using the BKUTIL5 to "pick a printer".  You
  101.      may set an option for how you want name searches to take place.  If you
  102.      put 0 (for no) on the "search for exact name with enter" line, then when
  103.      you type a name and press enter, it will show you all names with the same
  104.      first five letters in the first name and the same first five letters in
  105.      the last name. (This is basically the way version 4.5 operated.) If you set
  106.      that option to 1 (for yes), then if you type a name and there is at least
  107.  
  108.  
  109.      one exact match, then only exact matches will be shown.  If you want to
  110.      see non-exact matches you may still do so by typing the name and pressing
  111.      the F8 key instead of the enter key.
  112.  23. BKAUDIT is a file which contains information about changes that you have
  113.      made with Modify.  It will contain the date of change, the person's code
  114.      number, and the old and new value of changes to the name, any of the five
  115.      dates for a person, the ref field and the occupation field.  It will not
  116.      currently record the location changes or marriage information changes.
  117.  24. If you elect to show the date of last change for a person, please note
  118.      that the way it is currently set, if you move the cursor to any field of
  119.      a person in Modify, that will change the update date, even if you leave
  120.      the information the same.  However, if you view data with Modify, without
  121.      moving the cursor off the bottom line, the date will not be changed.
  122.  25. If you start a message line with the # character, the message line will
  123.      not print on any reports.  This is useful when you don't want to publish
  124.      very personal information, but still want to record it in the computer.
  125.      Even when you say to print All message lines, the # lines still will not
  126.      print.
  127.  26. In custom reports, if you ask to print the name of the spouse or the
  128.      marriage information, the first spouse and first marriage information will
  129.      normally print.  However, if you also pick field 98, then the last (most
  130.      recent) spouse and marriage will print.  If you pick field 99, then all
  131.      of a person's spouses and marriages will print.  If a person had multiple
  132.      marriages, each will print on a separate line in the appropriate column.
  133.  27. In BKUTIL5 you can print all locations, delete unused locations, and
  134.      change locations globally.  If you print all locations, you will most
  135.      likely find that you have entered several locations in different ways.
  136.      For example, you may find "Grand Rapids, Mich." and "Grand Rapids, Kent
  137.      County, Michigan" and "Grand Rapids, Kent Co., Mich." all listed.  This
  138.      is wasting disk space, so you may change all of them to be the same.
  139.      To do so, pick change location names, and then enter the ones to be
  140.      changed in the top box, and the one to change them all to in the second
  141.      box and everyone who uses any of those locations will be changed.
  142.  28. In the utility program, you may print all sources, delete unused sources,
  143.      and change sources.  This is similar to locations described above.  For
  144.      example, if you have entered a source for several different people, and
  145.      then you discover that you misspelled a word, you should use this routine
  146.      to change the source and it will correct it for everyone.  If you instead
  147.      use the Modify routine in BK, it will only change it for one person and
  148.      it will not change the description of the source for other people.
  149.  29. For Group sheets, you may print footnotes for the source notes that you
  150.      entered.  If you say yes for footnotes, you may then say yes or no for
  151.      the children's footnotes.  The children may have footnotes only if you
  152.      specify All data for children or if you specify Compressed data for
  153.      children.  On the line that says "Print source/reference footnotes?" you
  154.      may also enter the number 4 if you want the check field data to print as
  155.      it did in version 4.0 to 4.5.  If you pick "4", then it will not print
  156.      footnotes, it will just show the first part of the page field.  This
  157.      feature is to accommodate the users of 4.0 to 4.5 who may want to continue
  158.      printing the group sheets in the same way as version 4.
  159.  30. Also for Group sheets you may pick type C for compressed children data
  160.  
  161.  
  162.      and that will print a group sheet with lots of information packed onto
  163.      one page.  Several people have asked for a group sheet that shows all
  164.      information for up to 10 children on one sheet of paper.  The Compressed
  165.      choice will do this.
  166.  31. Also in Group sheets you may print an index of names and pages.  If you
  167.      ask for page numbers, then at the end of the report it will ask if you
  168.      also want to print an index.
  169.  32. Also in Group sheets, you may choose to omit blank date/location lines.
  170.      If you answer yes for this option, then any fields with blank information
  171.      will be skipped for the husband and wife (and the children if you have
  172.      selected all information for children.)  The birth and death lines will
  173.      still print even if the data fields are blank.
  174.  33. When the total number of people is shown at the bottom of the menu screen,
  175.      it is the actual number, which may be less than the highest code number
  176.      in use.  When you delete people, the deleted code number is not reused.
  177.      Perhaps there will be a way to reuse deleted code numbers in the future.
  178.      Even though the code number is not reused, the disk space is reused by
  179.      the next person you add.
  180.  34. The ancestor chart (when displayed on screen) allows easy movement to the
  181.      person's Father, Mother, Spouse, Older sibling, Younger sibling, children.
  182.  35. In addition to ALT-A thru ALT-Z, you can use ALT-1 thru ALT-0 and ALT-- and
  183.      ALT-= (basically the top row of white keys).  Alt fields are 78 characters.
  184.  36. The Tree charts can be twice as wide as they were in version 4.5, and if
  185.      the tree chart includes birth and death dates, ABT and CIR dates will also
  186.      show.
  187.  
  188.  
  189.  The CONVERT5 program will convert all version 4.5 data files to version 5.0.
  190.  Run CONVERT5 one time to convert your data.  If you have more than one set
  191.  of version 4.5 data files, you can run CONVERT5 twice and choose to ADD the
  192.  second set to the first.  The CONVERT5 program creates new files for use
  193.  with version 5.0, and will not change your version 4.5 data files, but just
  194.  to be on the safe side, make BACKUP copies of all your 4.5 data files before
  195.  you convert the data.
  196.  
  197.  Although I thought that the same number of names would take up less disk space
  198.  in version 5.0 than it did in 4.5, it may take up about 10-15 percent more
  199.  space for the same data.  Each name in 5.0 can store more information than in
  200.  version 4.5, therefore the record length is larger.  The data files are
  201.  partially compressed, but the indexes (which are part of the file) are not
  202.  compressed.  Each name record is indexed four ways: 1. by code number 2. by
  203.  exact name 3. by partial first and last name  4. by Ref field.
  204.  
  205.  The data files are quite complicated and are managed by Btrieve.  Whereas I
  206.  was able to edit the data files in version 4.5 to fix errors, I will not be
  207.  able to edit the data files in 5.0.  Therefore it is very important to have
  208.  backups of your data files.  If anything goes wrong with the data files, you
  209.  could loose everything in them, and you will have to go back to your backup
  210.  set.  Btrieve does contain some nice features which should save you from
  211.  disaster if the power goes off when writing to the file.  However, if the
  212.  files are damaged because of a disk going bad or developing bad sectors, you
  213.  
  214.  
  215.  will probably have to use your backup set of data files.  If your files are
  216.  too large to backup with the backup routine available from the menu, be sure
  217.  to BACKUP the data files with another program.  The files that are important
  218.  to backup are all the files that end with the .DT5 extension.  You could use
  219.  the DOS BACKUP program, or another program such as PC-TOOLS or FASTBACK, or if
  220.  you have the ARC or PKZIP program, you could compress the files and then copy
  221.  them.  You will find that PKZIP or ARC will compress the files to about 1/4th
  222.  the original size and that should help you fit them onto diskettes.
  223.  
  224.  If your data files are damaged, save all your current backup diskettes, and
  225.  use new blank floppy diskettes to make new backups.  There are a couple
  226.  programs available that are designed to fix damaged Btrieve files, but nothing
  227.  is better than having a couple sets of current backup disks.  One program that
  228.  is used to fix damaged Btrieve data files is call BTRHELP and it is available
  229.  on CompuServe and is available on my BBS.
  230.  
  231.  This version 5.0 of Brother's Keeper uses a program called Btrieve to manage
  232.  the data files.  Btrieve handles all the indexes of names and numbers in the
  233.  database.  Version 5.0 of BK does not have to "read the alpha file" each time
  234.  it starts since the indexes are part of the data files.  Btrieve is a memory
  235.  resident program which loads just before the BK program starts, and which is
  236.  removed from memory when the BK program stops.  When you type BK5 to start
  237.  Brother's Keeper, it first loads Btrieve, and then starts BK5MAIN which is
  238.  the main part of BK.  The routines on the menu which are labeled "external
  239.  reports" are separate programs which are run when selected.  When the external
  240.  report is finished, you may choose to run the same report again, or to return
  241.  to the BK5MAIN program, or to stop.  If you ran BK 4.5 with over 1,000 names,
  242.  you should find that starting BK will be faster in version 5.0 since the
  243.  program does not have to read the ALPHA file each time.
  244.  
  245.  In Occupation field, press CTRL-A to set the parent type.  Each time it is
  246.  pressed, it changes through 9 possibilities.  (Adopted, Step, Foster, etc)
  247.  If you do this on the modify screen, it will show the type of parent after
  248.  both the father and the mother.  (In Add it just shows on the bottom line).
  249.  
  250.  Each person may have two sets of parents.  For example, birth parents and
  251.  adopted parents.  (Or step parents or foster parents.)  When adding a child,
  252.  just type the name and F8 to search, and it will let you add the child to the
  253.  second family.  Then it will jump to the occupation field and you may set the
  254.  parent type by pressing CTRL-A.  Each press of CTRL-A will display the next
  255.  type of parent for father/mother.  (On the modify screen, it will show the
  256.  type of parent after each parent's name.  You may press CTRL-A in the
  257.  occupation field on modify also.)
  258.  
  259.  Each date/location line can have Source information entered.  Press F6 to
  260.  enter Source information (up to 3 lines.)  When duplicating a previously
  261.  entered source, type a couple words and press F8.  After the three lines of
  262.  source information, there is a Page field.  If the source is a book, enter the
  263.  page numbers in that field.  Enter the word Page also.  If the source is
  264.  microfilm, then enter the reel number in the page field.  Enter the word reel
  265.  and then the number.  (If you used the check fields in version 4 of BK, then
  266.  
  267.  
  268.  the data from those fields may be in this Page field.  Depending on what you
  269.  used the check fields for, you may need to move that data.)  Each unique set
  270.  of 3 source lines is saved only once on the disk in order to save disk space.
  271.  Therefore, use the F8 key to recall the previously saved source so that it
  272.  will exactly match.  Use the page field to enter information that is unique
  273.  for this date.
  274.  
  275.  Press F4 when in a date or location field to bring up a screen for entering a
  276.  person's mailing address and phone number.  Press Ctrl-L to print a label.
  277.  You can control which label lines will print, and the size of the label by
  278.  adjusting the numbers on option screen 3.  For example, you may want to have
  279.  a line in the address field that does not print on the label, such as the
  280.  phone number.  To print a group of address labels, pick N from the main menu
  281.  and then print a custom report with only a field number of 95.
  282.  
  283.  When in a name field, (while in Add or Modify) press F6 to enter an alternate
  284.  name for a person.  I suggest you enter the birth name in the normal name
  285.  field and the current name in the alternate name field.  This is for people
  286.  who have changed their name or have been adopted and use a new last name.
  287.  
  288.  When entering a name, the program will normally be able to automatically
  289.  figure out what the last name is for the person.  It will catch common two
  290.  part last names, and will ignore Jr or Sr after a name.  Occasionally, the
  291.  program will not be able to determine the correct last name.  In that case,
  292.  put [] around the last name.  Example: "John [Steed] of Kent" will be indexed
  293.  under the last name of Steed instead of Kent.  The [] will not print on
  294.  reports, but will show on the Add and Modify screens.  Routines which need the
  295.  last name (such as the alphabetical report and the birthday report) will look
  296.  for the [] brackets and use that name for the last name.  For most names, you
  297.  will not need to use the brackets.  If you don't want to use the characters [
  298.  and ] then change the characters on option screen 3.
  299.  
  300.  If you enter a reference number or code in the Ref: field, you will be able to
  301.  find people by entering that number or code.  This is useful if you want to
  302.  use your own numbering system and what to be able to find people using that
  303.  number.  To find someone by ref number, when you are asked for a name to find,
  304.  type either a / or a \ followed by whatever is in the ref field (exact match
  305.  only).  Example:  If you have JS1234 in the reference field, then type /JS1234
  306.  to find that person.  Note: do not type the / in the ref field - only type it
  307.  when searching for a person.  So there are three ways to find someone  1. Type
  308.  their name  2. Type their code number.  3. Type a / and then their reference
  309.  field.  If two or more people have the same Ref: info, each will be shown by
  310.  pressing TAB.
  311.  
  312.  When typing a location, if it is the same as a location already entered
  313.  previously, type the first part of the location name and then press F8 to
  314.  search for matching entries.  They will be displayed and you may use the up
  315.  and down arrows to point to the location you want and then press enter.  This
  316.  will guarantee that the locations are typed exactly the same and that will
  317.  save disk space.  (Each unique location is only saved once on the disk even if
  318.  several hundred people use that location.)  If you have mostly unique location
  319.  
  320.  
  321.  names, the location file will be large, but if you have lots of duplicates,
  322.  the location file should be smaller than it was in version 4.5
  323.  
  324.  In version 4.5, if you typed *UNKNOWN for a husband or wife name, it would not
  325.  print that name on reports, but it did take up 1 record.  In version 5.0, you
  326.  may type *UNKNOWN for a husband or wife name, and it will not create a record
  327.  at all for that person.  The "marriage" will contain only one partner.  If you
  328.  later discover the name for the unknown partner, you can change the unknown
  329.  person into a real person in this way:  Go to Modify and call up the known
  330.  person.  Then press F6 to jump to the add routine.  Then after selecting the
  331.  correct person, use the up arrow key to change the name from *UNKNOWN to the
  332.  actual name.  The existing marriage will then connect those two people and any
  333.  children linked to previously known partner will still be correctly linked.
  334.  
  335.  There is a menu item for adding an individual.  Sometimes, the normal Add
  336.  routine (which adds a family all at one time) may not be what you want.  In
  337.  that case, pick I to add an individual.  This individual will not be linked to
  338.  anyone else.  If you later want to link that person to a spouse, parent, or
  339.  child, then use the normal Add routine and call up that person in the desired
  340.  location by either searching by name or by typing in the person's code number.
  341.  
  342.  I have just started a BBS, so if you have a modem, you can call for all
  343.  programs, and for any fixes to the programs.  From experience I believe there
  344.  will be several changes to the programs in the next few weeks as I get
  345.  feedback about this new version.  The BBS (computer bulletin board service)
  346.  number is (616) 364-1127 and it uses an HST dual standard modem, so it can
  347.  handle 1200, 2400, 9600, and 14400 baud modems.  The programs are large, so
  348.  find a fast modem and call when the phone rates are cheap.  The board is
  349.  available for downloads to first time callers.
  350.  
  351.  If by chance you are not a registered user of Brother's Keeper, here is
  352.  registration form.
  353.  
  354.  
  355.  
  356.    To: John Steed                              Date _______________________
  357.        6907 Childsdale Rd
  358.        Rockford, MI  49341   U.S.A.
  359.  
  360.          I have version 5.0 of Brother's Keeper.  (11/30/91)
  361.     __
  362.    |__|  I would like to become a Registered user.  Enclosed is a check for
  363.          $45 (U.S. check or Canadian check in U.S. funds) or MasterCard or VISA
  364.          number and expiration date.  Please send me the printed manual
  365.          and the current version of the programs. ($45 includes all programs.)
  366.     __
  367.    |__|  I have data in Brother's Keeper version ________  Please send the
  368.          CONVERT5 program also.
  369.     __
  370.    |__|  Please send information on genealogy computer bulletin boards.
  371.     __
  372.    |__|  I have data in  ___Genealogy on Display   ___FHS   ___Linkages and
  373.          would like a program to transfer the data to Brother's Keeper.
  374.     __
  375.    |__|  Send the program in __French   __German   __Danish   __Polish   __Dutch
  376.            __Swedish   __Finnish   __Norwegian
  377.            (Translations are available in version 4.5 now and some will not be
  378.            available in version 5.0 until after February 1992.)
  379.          __send the translation program so that I may translate to ____________
  380.  
  381.          I am using the program on the following type of equipment.
  382.  
  383.          Computer brand _________________________ Do you have a modem? _____
  384.  
  385.          Amount of RAM memory     384     512      640     _________
  386.  
  387.          Hard disk?          Yes        No
  388.  
  389.          Diskette size preference      3 1/2      5 1/4
  390.  
  391.          Monitor             mono       color -  CGA     EGA     VGA
  392.  
  393.          Printer      __________________________
  394.  
  395.    Name / Address     ______________________________________________
  396.  
  397.                       ______________________________________________
  398.  
  399.                       ______________________________________________
  400.  
  401.                       Country ______________________________________
  402.  
  403.    Comments and suggestions:  _________________________________________________
  404.  
  405.    ____________________________________________________________________________
  406.    use back side also
  407.  
  408.    (Thank you very much for responding.  John)
  409.  
  410.